home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2004 #11 / Amiga Plus CD - 2004 - No. 11.iso / AmiSoft / Misc / emu / xmamegui.readme < prev   
Text File  |  2004-09-23  |  5KB  |  140 lines
  1. Short:        GUI for the OS4 xMAME port v0.7
  2. Author:       Alexander Weber
  3. Uploader:     Alexander Weber
  4. Version:      0.7
  5. Type:         misc/emu
  6. Requires:     AmigaOS4, xmame_0.82.1.lha (or higher)
  7. Architecture: ppc-amigaos >= 4.0.0 
  8.  
  9. This is a GUI for the OS4 xMAME ports made by Steffen Häuser. It supports
  10. xMAME, xNeoMAME and xCpMAME.
  11.  
  12. There is no installation needed. You can just copy the executable anywhere. It
  13. will search for the MAME executables and the installed ROM's in the MAME:
  14. directory.
  15. When you start the GUI the first time, it will create a file called "gamelist"
  16. in the MAME: directory. The file is used for displaying the full names of the
  17. ROM's. This is done by running xMAME.SDL (if it exists) with the -listfull
  18. option, so it can take a few seconds.
  19.  
  20. Tooltypes:
  21. WIDTH=n: The width of the GUI window on startup
  22. HEIGHT=n: The height of the GUI window on startup
  23. AUTOLOADGAMEPREFS: If present, the GUI will automatically load the individual
  24.   prefs of the games when clicking on them
  25.  
  26. Shell arguments:
  27. WIDTH/N: The width of the GUI window on startup
  28. HEIGHT/N: The height of the GUI window on startup
  29. AUTOLOADGAMEPREFS/T: If active, the GUI will automatically load the individual
  30.   prefs of the games when clicking on them
  31.  
  32. GUI Usage:
  33. - If you have more than one MAME executable installed, there will be a chooser
  34.   gadget where you can select which one to start.
  35.  
  36. - Frameskip: The checkbox turns frameskip on and off and the slider gadget
  37.   chooses how many frames should be skipped. Only available if auto frameskip
  38.   is off.
  39.  
  40. - Fullscreen: Runs the emulation in an own screen when turned on, otherwise it
  41.   will open a window on the Workbench.
  42.  
  43. - Resolution: Selects the resolution for the emulation screen. You can choose
  44.   between several pre-defined resolutions or decide to let MAME choose the
  45.   screen mode automatically.
  46.   Note: The automatic mode will not work if there is a resolution defined in
  47.   the prefs file. You will have to save the prefs first. Also, if there is a
  48.   resolution defined in the MAME:xmamerc file, automatic choosing of the
  49.   resolution will not work for the individual game prefs.
  50.  
  51. - Auto frameskip: Enable/Disable automatic skipping of frames. Only available
  52.   if frameskip is off.
  53.  
  54. - Sound: Turn sound on or off.
  55.  
  56. - Sample freq.: The sample frequency for the sound output (8000-48000). Only
  57.   available if sound is turned on.
  58.  
  59. - Available ROM's: A list of all ROM's found in the MAME:roms/ directory is
  60.   displayed here. You can choose a game by clicking on its name. If the
  61.   automatic loading of game prefs is active, clicking on a game will also load
  62.   its individual options.
  63.  
  64. - Load Game Prefs: Loads the options for the ROM that is currently selected in
  65.   the "Available ROM's" list. The options are loaded from a file called
  66.   "MAME:rc/{ROM}rc" where {ROM} is the name of the selected ROM.
  67.  
  68. - Save Game Prefs: Saves the options for the ROM that is currently selected in
  69.   the "Available ROM's" list. The options are saved in a file called
  70.   "MAME:rc/{ROM}rc" where {ROM} is the name of the selected ROM.
  71.   This way you can have individual preferences for each game. If the directory
  72.   "MAME:rc" doesn't exist, it is automatically created.
  73.   Note: Options that were present in the prefs file and that are not supported
  74.   by the GUI will be left untouched when saving.
  75.  
  76. - Start MAME: Starts the emulation with the selected options.
  77.  
  78. - Load Prefs: Loads the options stored in the file MAME:xmamerc.
  79.  
  80. - Save Prefs: Writes the selected options into the file MAME:xmamerc.
  81.   Note: Options that are not supported by the GUI will be left untouched when
  82.   saving.
  83.  
  84. - Quit: Closes the GUI.
  85.  
  86. Menu usage:
  87. - Project:
  88.   - Start MAME: Starts the emulation with the selected options.
  89.   - Create game list file: Starts xMAME.SDL with the -listfull option in order
  90.     to create a file called "gamelist". This file is used for displaying the
  91.     full names of the ROM's in the ROM list viewer. This option is only
  92.     available if there is an xMAME.SDL executable in the MAME: directory. The
  93.     option will not have an effect on the ROM list viewer until you restart
  94.     the GUI.
  95.     Note: The GUI will create such a file automatically on startup if it
  96.     doesn't exist. So you will only really need this option when xMAME is
  97.     updated and supports new games.
  98.   - Quit: Closes the GUI.
  99.  
  100. - Prefs:
  101.   - Auto-load game prefs: If active, clicking on a ROM in the "Available
  102.     ROM's" list will automatically load the individual prefs of the ROM if
  103.     present.
  104.   - Load Prefs: Loads the options stored in the file MAME:xmamerc.
  105.   - Save Prefs: Writes the selected options into the file MAME:xmamerc.
  106.     Note: Options that are not supported by the GUI will be left untouched when
  107.     saving.
  108.  
  109. Report bugs/requests to alexwe@alexwe.de
  110.  
  111. Have fun,
  112.  
  113. Alexander Weber.
  114.  
  115. Version history:
  116. v0.7 (22.08.2004):
  117.     Each ROM can have its individual options now
  118.     New option: Screen mode
  119.     Memory leak fixed
  120.     Small change and bugfix in saving of prefs
  121.     Method of tool type reading changed
  122. v0.6 (08.08.2004):
  123.     ROM's are now displayed by their full name
  124.     Menu added
  125.     I have finally drawn a Workbench icon for this thing
  126. v0.5 (30.06.2004):
  127.     Reduced the max frameskip value to 11
  128.     Changed sorting algorithm to ignore case
  129.     Added sample frequency option
  130. v0.4 (22.06.2004):
  131.     Added support for zipped ROM's
  132.     ROM list is sorted
  133. v0.3 (19.06.2004):
  134.     Native OS4 version
  135. v0.2 (10.04.2004):
  136.     Added several options
  137.     Added WITH/HEIGHT tooltypes
  138. v0.1 (01.04.2004):
  139.     Initial version
  140.